559780738f652dad93875a550e68d24a94e1f728
[git-annex.git] /
1 [[!comment format=mdwn
2  username="joey"
3  subject="""comment 5"""
4  date="2023-05-16T16:32:51Z"
5  content="""
6 sync's intent is to replicate as close as possible the following common
7 git workflow:
8
9         first stage some changes, and then run:
10         git commit -m foo
11         git pull
12         git push
13
14 Since git-annex has some complications involving pulling and pushing 
15 the git-annex branch, and transferring the content, it adds a learning
16 curve that was too high. Giving users one new command to learn minimizes
17 the learning curve. (It's unfortunate it didn't originally send content,
18 and annex.synccontent aims to fix that oversight and I hope it may eventually
19 become default.)
20
21 For git-annex sync to default to doing something not in the above
22 pull+commit+push workflow would be surprising, because that's the workflow
23 users have been told it handles.
24
25 Notice that the git-annex assistant will happily add all files to the
26 repository and send their content. That's because it's *not* targeting
27 users who expect to use that git workflow. So it's not surprising that it
28 does what it does.
29
30 In conclusion, if having this behavior enabled by git config is not useful,
31 then it does not belong in `git-annex sync`. It could go in a new command.
32 """]]